Add bindings and docs for the host.dmesg_clear call.

Signed-off-by: Ewan Mellor <ewan@xensource.com>

diff --git a/docs/xen-api/xenapi-datamodel.tex b/docs/xen-api/xenapi-datamodel.tex
index 01b980d8a295223128ed9e00c8c4332cd145252e..2ed8ab1350a3a66576776180b92b48895249c202 100644 (file)
--- a/docs/xen-api/xenapi-datamodel.tex
+++ b/docs/xen-api/xenapi-datamodel.tex
@@ -4915,6 +4915,38 @@ string
 }
 
 
+dmesg string
+\vspace{0.3cm}
+\vspace{0.3cm}
+\vspace{0.3cm}
+\subsubsection{RPC name:~dmesg\_clear}
+
+{\bf Overview:} 
+Get the host xen dmesg, and clear the buffer.
+
+ \noindent {\bf Signature:} 
+\begin{verbatim} string dmesg_clear (session_id s, host ref host)\end{verbatim}
+
+
+\noindent{\bf Arguments:}
+
+ 
+\vspace{0.3cm}
+\begin{tabular}{|c|c|p{7cm}|}
+ \hline
+{\bf type} & {\bf name} & {\bf description} \\ \hline
+{\tt host ref } & host & The Host to query \\ \hline 
+
+\end{tabular}
+
+\vspace{0.3cm}
+
+ \noindent {\bf Return Type:} 
+{\tt 
+string
+}
+
+
 dmesg string
 \vspace{0.3cm}
 \vspace{0.3cm}

diff --git a/tools/libxen/include/xen_host.h b/tools/libxen/include/xen_host.h
index 1fbe0143258f056422864e6b67e3e251b4b6fc1c..a27c8756870fb239c3cd9d571efc839dc5ce08e4 100644 (file)
--- a/tools/libxen/include/xen_host.h
+++ b/tools/libxen/include/xen_host.h
@@ -414,7 +414,7 @@ xen_host_enable(xen_session *session, xen_host host);
 
 /**
  * Shutdown the host. (This function can only be called if there are no
- * currently running VMs on the host and it is disabled.)
+ * currently running VMs on the host and it is disabled.).
  */
 extern bool
 xen_host_shutdown(xen_session *session, xen_host host);
@@ -422,7 +422,7 @@ xen_host_shutdown(xen_session *session, xen_host host);
 
 /**
  * Reboot the host. (This function can only be called if there are no
- * currently running VMs on the host and it is disabled.)
+ * currently running VMs on the host and it is disabled.).
  */
 extern bool
 xen_host_reboot(xen_session *session, xen_host host);
@@ -435,6 +435,13 @@ extern bool
 xen_host_dmesg(xen_session *session, char **result, xen_host host);
 
 
+/**
+ * Get the host xen dmesg, and clear the buffer.
+ */
+extern bool
+xen_host_dmesg_clear(xen_session *session, char **result, xen_host host);
+
+
 /**
  * List all supported methods.
  */

diff --git a/tools/libxen/src/xen_host.c b/tools/libxen/src/xen_host.c
index d46f061c30af4349a9b839e03115969cfc7f8db5..2ae37fefe4e874b95ec68fae4a9e1ee48263fa8e 100644 (file)
--- a/tools/libxen/src/xen_host.c
+++ b/tools/libxen/src/xen_host.c
@@ -739,6 +739,23 @@ xen_host_dmesg(xen_session *session, char **result, xen_host host)
 }
 
 
+bool
+xen_host_dmesg_clear(xen_session *session, char **result, xen_host host)
+{
+    abstract_value param_values[] =
+        {
+            { .type = &abstract_type_string,
+              .u.string_val = host }
+        };
+
+    abstract_type result_type = abstract_type_string;
+
+    *result = NULL;
+    XEN_CALL_("host.dmesg_clear");
+    return session->ok;
+}
+
+
 bool
 xen_host_list_methods(xen_session *session, struct xen_string_set **result)
 {